Back to Main Menu

QGIS Integration Introduction

Introduction

A common workflow when an organisation builds or receives a new asset is to create a new feature for the asset in QGIS, and then create a corresponding asset in Assetic. Assetic has created a set of data capture integration tools to ensure that a new asset in Assetic is linked to the correct feature in QGIS.

 
Note: This integration is designed to be used with QGIS version 3.

 

The integration supports the following actions:

  • Create Asset in Assetic
  • Update Asset in Assetic - updates the asset attributes
  • Create Functional Location
  • Update Functional Location

 

For asset creation and update the following are optionally supported:

  • Component and network measure
  • Spatial definition
  • Functional Location association

Integration Architecture

When QGIS is installed it includes a set of python tools to allow interaction with the spatial data via python.

 

Assetic have built a python package 'assetic-qgis' that utilises these tools to assist with creating and maintaining asset records in both systems. The 'assetic-qgis' package assists with getting relevant asset detail from a QGIS feature and applying that detail in Assetic, and if necessary updating the QGIS feature with relevant detail (such as an asset ID generated by Assetic on asset creation). The 'assetic-qgis' package itself relies on the generic Assetic python SDK packaged as 'assetic'.

 

QGIS provides a 'Processing Toolbox' where the integration is initiated via a python script.  This script initiates the 'assetic-qgis' package and uses the tools in that package to complete the integration tasks.

Next Steps

  1. Install the Assetic QGIS Integration package assetic-qgis.  Refer to the following article: QGIS Install Integration Package
  2. Create the configuration files required by the assetic-qgis package.  Configuration is detailed in the article QGIS Integration Configuration
  3.  Add the script(s) that execute the integration to the QGIS Processing Toolbox.  Refer to the following article: QGIS Integration Execution